package com.sky.mapper;

import com.sky.entity.FinancialTransaction;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.math.BigDecimal;
import java.time.LocalDateTime;
import java.util.List;
import java.util.Map;

/**
 * 交易流水 Mapper。
 * 负责交易记录的新增、分页查询、计数与按方向汇总。
 */
@Mapper
public interface FinancialTransactionMapper {
    /** 插入一条交易记录 */
    void insert(FinancialTransaction tx);

    /**
     * 按条件分页查询交易记录。
     * params 支持 merchantId、direction、category、startTime、endTime、offset、pageSize 等键。
     */
    List<FinancialTransaction> selectByPage(Map<String, Object> params);

    /** 统计分页条件下的总记录数 */
    Long countByPage(Map<String, Object> params);

    /**
     * 根据方向汇总金额。
     * direction 取值 INCOME/EXPENSE。
     */
    BigDecimal sumAmountByDirection(@Param("direction") String direction,
                                    @Param("merchantId") Long merchantId,
                                    @Param("startTime") LocalDateTime startTime,
                                    @Param("endTime") LocalDateTime endTime);
}